home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / showobj.readme < prev    next >
Text File  |  1996-09-07  |  6KB  |  181 lines
  1. ---------------------------------------------------------------------------
  2.                                  Showobj V2.0
  3.                          A Imagine TDDD-object displayer.
  4.                         Copyright 1994 by Andreas Heumann.
  5.                               All Rights reserverd.
  6. ---------------------------------------------------------------------------
  7.  
  8. Requirements
  9. ============
  10.  
  11. Showobj requires at least OS 2.0, nevertheless it should run on any machine
  12. with any processor.
  13. Tested with:
  14. A2000 4Mb 68030/882 ECS
  15. A2000 9Mb 60040, Merlin Gfx Board
  16.  
  17. Introduction
  18. ============
  19.  
  20. Showobj takes a file in Imagine's TDDD (3D data description) format
  21. and displays it's contents in a window on a public screen, or if no
  22. is given on Workbench. If no filename is given, the program will ask for
  23. it with a filerequester.
  24.  
  25. Showobj can display the objects in three different modes:
  26. - boundingbox mode
  27. - wireframe mode
  28. - solid mode
  29.  
  30. Four views can be selected:
  31. - front view
  32. - right view
  33. - top view
  34. - perspective view
  35.  
  36. In perspective view the object can be rotated with the mouse while
  37. pressing the left mouse button.
  38. With the cursor keys in object is moved in front, right and top view,
  39. and rotated in perspective view.
  40.  
  41. It`s possible to track the Camera in perspective mode to the objects,
  42. and get information about them. Objects tracking to are drawed in a
  43. different color.
  44.  
  45. Solid mode is realized with a Z-Buffer algorithm which will take a large
  46. amount of memory in high resolution modes (655kByte with 640x256,
  47. 1,8Mb with 800x600 and 3Mb with 1024x768).
  48. If there's not enough memory available the window is divided into stripes.
  49.  
  50. Showobj can read and display:
  51. - normal Objects saved in detail editor
  52. - perfect spheres
  53. - grounds
  54.  
  55. It can't read and display:
  56. - Lamps
  57. - Others than the first state of a state-object
  58. - Others than the first state of a cycle-object
  59. - Paths
  60. - Objects saved in forms or spline editor
  61.  
  62. Usage
  63. =====
  64.  
  65. showobj [verbose] [pubscreen <name>] filename
  66.  
  67. With:
  68.  
  69. verbose   verbose mode, displays information about file
  70.           (names of Objects; number of objects, faces, edges and
  71.            points)
  72.  
  73. pubscreen opens showobj window on given pubscreen
  74.  
  75. filename  name of the TDDD-file which is displayed, if no name is given
  76.              a filerequester appears.
  77.  
  78. This keys can be used while displaying the object:
  79.  
  80. ESC    -    Quit
  81. HELP    -    Showes keys used by showobj
  82. a        -    Showes informations about object
  83. w        -    Switches wireframe mode on
  84. b        -    Switches bounding box on
  85. s        -    Switches solid mode on
  86. f        -    Switches to front view
  87. r        -    Switches to right view
  88. t        -    Switches to top view
  89. p        -    Switches to perspective view
  90. i        -    Zoomes in
  91. o        -    Zoomes out
  92. n        -    Track to next object
  93. Cursorkeys to move in front, right and top view and to rotate in
  94.             perspective view
  95.  
  96. Disclaimer
  97. ==========
  98.  
  99. Standard disclaimer:
  100.  
  101. THERE IS NO WARRANTY FOR THIS PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE
  102. LAW.  EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  103. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
  104. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  105. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  106. ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  107. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  108. SERVICING, REPAIR OR CORRECTION.
  109.  
  110. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  111. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  112. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  113. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  114. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  115. DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  116. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
  117. SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  118. DAMAGES.
  119.  
  120. Copyright
  121. =========
  122.  
  123. Showobj 2.0 is Copyright 1994 by Andreas Heumann. All Rights Reserved. It is
  124. released under the concept of `Cardware'. So if you like it please send me
  125. a postcard of your city. It has never been, nor will it ever be in the
  126. `Public Domain'.
  127.  
  128. The archive may only be distributed in unmodified form.  No files may be
  129. added, changed or removed. You may not charge for this archive, other than
  130. the cost of the media and duplication fees. Distribution is allowed in all
  131. forms, such as BB systems, floppy or compact disks, and ftp sites.
  132.  
  133. Any inclusion in a commercial, semi-commercial or Shareware distribution
  134. requires the written permission of the author.
  135.  
  136. History
  137. =======
  138.  
  139. 07.06.1994    first public release (1.0)
  140. 12.09.1994    added asl filerequester (1.01)
  141. 03.10.1994    added solid mode (1.02)
  142. 09.11.1994    added perspective mode (1.03)
  143. 02.12.1994    added z-buffer (YEAH!!) (1.1)
  144. 15.12.1994    z-buffer now works with stripes (1.11)
  145. 16.12.1994    added perfect sphere and ground (with SHP2- and SHAP-Chunk)
  146. 18.12.1994    some minor changes, cleanup (2.0)
  147.  
  148. Author
  149. ======
  150.  
  151. For bug reports, comments, suggestions ... you can contact me at the
  152. following address.
  153.  
  154.     Andreas Heumann
  155.     Heilmeyersteige 105
  156.     89075 Ulm
  157.     Germany
  158.  
  159.    E-Mail: heumann@hugo.rz.fh-ulm.de
  160.  
  161. Thanks
  162. ======
  163.  
  164. Special thanks goes to:
  165.     Massimo Tofani
  166.     Alessio Cappelli
  167. for their postcards and suggestions,
  168.     Christian Geisert
  169.     Nigel Critten
  170. for writing through E-Mail.
  171.  
  172. Also thanks to Mike Hesser for help and motivation and to Stephan Dorenkamp
  173. for testing.
  174.  
  175. Planed for the future
  176. =====================
  177.  
  178.  - 16 color grayscale solid
  179.  - Lightwave support
  180.  - speed up (hope to get new compiler soon)
  181.